Log Files

When you run processes via the Cobra API, Cobra creates log files that capture information about the processes that were performed.

For processes that operate on a project, Cobra creates a subdirectory with the same name as the project under the batch log directory. In most cases, log files generated by the process are saved in this subdirectory. For processes that do not operate on a project, log files are created in the root of the log directory using the standard log filename created by that process.

Each log file includes the name of the process with the date and time in the following format:

<process>-YYYY-MM-DD HH.MM

• Time is in the 24-hour format.
• The date and time used are the date and time when the log file is created. This is usually the same time that the process finishes.

For example, a script file called Calcev.txt (which Cobra uses to calculate earned value in the Demoadv project) creates a log file named calcev-2001-03-23 13.46.log in the subdirectory Logs\Demoadv.

API Process Log

After running an API process, Cobra creates an overall API process log where information about the API process is entered. This file, called Batch.API.log is created in the user’s working folder.

If the folder specified in the API script cannot be easily determined, a subdirectory cannot be created. If the log file is generated in the base log directory, you can overlook the file since it will have a similar name as the main API log file. Messages are displayed in the main API log file instead of a new one being created.

Integration Process with Projects

For integration processes that reference a scheduling tool and a project, the integration log file includes the name of the scheduling project and is exported to the project’s subdirectory.

For example, if importing data from project SHIP into Cobra project SHIPNEW, the following will be the integration log file:

<Log directory>\SHIPNEW\intg - ship <datetime>.log

Integration Process with Import Files and Projects

For integration processes that reference import files and projects, the log file uses the name of the activity import file. If importing only the status, the status import file is used.

For example, if importing schedule from an import file SHIPDATA into Cobra project SHIPNEW, the following will be the integration log file:

<Logdirectory>\SHIPNEW\intg - shipdata <datetime>.log

Integration Process with Non-Cobra Projects

For integration processes that reference a non-Cobra project, the log file uses the project name and is stored in the root of the log directory. For example, if importing only code files from an Open Plan project SHIPDATA, the following is the integration log file:

<Log directory>\intg - shipdata - <datetime>.log

Other Logs

Cobra never overwrites this file and messages are appended to the bottom of the file.